Release 10.1A: OpenEdge Development:
Progress 4GL Reference

NAME attribute

A string identifier for the specified object or widget.

Data type: CHARACTER

Access: Readable/Writeable

Applies to: Asynchronous request object handle, BROWSE widget (browse and cell), Buffer object handle, Buffer-field object handle, BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, ProDataSet object handle, Data-relation object handle, Data-source object handle, DIALOG-BOX widget, EDITOR widget, FIELD-GROUP widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, MENU widget, MENU-ITEM widget, Query object handle, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, Server object handle, Server socket object handle, SLIDER widget, SOAP-header object handle, SOAP-header-entryref object handle, Socket object handle, SUB-MENU widget, Temp-table object handle, TEXT widget, THIS-PROCEDURE system handle, TOGGLE-BOX widget, WINDOW widget, X-document object handle, X-noderef object handle

For the SOAP-header and SOAP-header-entryref object handles, this attribute is read-only.

For static data representation widgets, the default value is the name of the field or variable associated with the widget. You can use the NAME attribute to store any information associated with the widget.

For a state-reset, state-aware, or stateless AppServer, this attribute returns the connection ID for the AppServer associated with the server handle. For a state-free AppServer, it returns the connection ID of the first AppServer connection created in the session pool with this server handle when the application service is first bound using the CONNECT( ) method. The default value is the unique connection name of the AppServer.

For Web services, the default value is the URL of the Web service procedure object from the WSDL. This is the portType name used on the RUN statement that instantiated this object.

For a non-Web service procedure, returns the pathname of the procedure file that contains the current procedure.

For control-frames, this attribute maps to the Name property of the of the control-frame COM object (ActiveX control container).

For dynamic widgets and asynchronous request handles, this attribute defaults to the Unknown value (?).

Caution: If you change the value of this property at run time, any OCX event procedures that you have defined for a corresponding ActiveX control will not respond to control events because the events are sent with the new name.

For query objects, the NAME attribute applies only to static queries. For more information on query objects, see OpenEdge Development: Progress 4GL Handbook .

For the SOAP-header object handle, this attribute is the qualified name of the SOAP-header object, which consists of a namespace prefix + “:” + HEADER.

For the SOAP-header-entryref object handle, this attribute is the qualified name of the SOAP-header-entryref object, which consists of a namespace prefix + “:” + localname. You cannot change this attribute directly; you must use the local-name and namespace-prefix.

For temp-table objects, this attribute is read-only and returns the name of the temp-table as specified in the TEMP-TABLE-PREPARE method. If TEMP-TABLE-PREPARE( ) has not been called or the name has been cleared by CLEAR( ) and no subsequent TEMP-TABLE-PREPARE( ) has been called, then this attribute returns the Unknown value (?), which means that the table is in the UNPREPARED state.

For the X-document object handle or X-noderef object handle, this attribute returns the name of the XML node.

For any object or widget, this attribute can contain any arbitrary value that you set.